home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / becproto.zip / SK&J0126.ZIP / SUPERK.DOC < prev   
Text File  |  1989-01-26  |  29KB  |  609 lines
  1. SuperK v3.16  MiniNet's External Protocol Driver
  2.  
  3. Protocols Supported: Xmodem Checksum, Xmodem CRC, Ymodem (1k Xmodem) CRC
  4.                      WXmodem, K9Xmodem and Super8K - Batch or Single File
  5.  
  6. Copyright 12/4/1986, 1989 by Crater Rim Software. All Rights Reserved.
  7.  
  8. = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
  9.  
  10. SuperK Licensing Agreement
  11. --------------------------
  12.    This program is the sole property of Crater  Rim  Software.  For  the 
  13.    sake of clarity, all references and restrictions to the use of SuperK 
  14.    also  apply  to any and all of the associated support files (included 
  15.    with or created by) SuperK. 
  16.  
  17.    SuperK,  its overlays and all of its associated support files are not 
  18.    public  domain  software,  nor  are  they  free  software.  SuperK is 
  19.    copyright (c) 1988 by Crater Rim Software. All rights reserved. 
  20.  
  21.    Users are granted a limited license to use SuperK free of charge  BUT 
  22.    subject to the following limitations: 
  23.  
  24.      No user may modify SuperK in any way,  including but not limited 
  25.      to decompiling,  disassembling or otherwise reverse  engineering 
  26.      the program. 
  27.  
  28.      SuperK must be copied in unmodified form, complete with the file 
  29.      containing this license information. 
  30.  
  31.      Any and all SuperK documentation must be included with the copy.  
  32.      No  fee,  charge  or  other  compensation  may  be  accepted  or 
  33.      requested by any licensee. 
  34.  
  35.      SuperK  may  not  be  distributed  in conjunction with any other 
  36.      product without prior arrangements with Crater Rim Software. 
  37.  
  38.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  39.    ********* ALL THIS IS SAYING IS THAT I WANT TO KNOW WHO HAS *********
  40.    *********    (and is using)  THIS FILE!  NOTHING MORE...    *********  
  41.    *                                                                   *
  42.    * Operators  of electronic bulletin board systems (Sysops) may post *
  43.    * SuperK for downloading by their users  and  may  use  the  SuperK *
  44.    * module  only  as  long as the above conditions are met and Crater *
  45.    * Rim Software has been notified of your intent to use SuperK       *
  46.    *                                                                   *
  47.    ******** ALL THIS IS SAYING IS THAT I WANT TO KNOW WHO HAS **********
  48.    ********    (and is using)  THIS FILE!  NOTHING MORE...    **********  
  49.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  50.  
  51.    Those organizations who distribute public domain  or  user  supported 
  52.    software  on a pay per diskette basis may distribute copies of SuperK 
  53.    under the above conditions ONLY AFTER  OBTAINING  WRITTEN  PERMISSION 
  54.    from  Crater  Rim  Software.  Such  permission  usually  is  granted.  
  55.    Please write or call for details. 
  56.  
  57.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  58.  
  59.                    Software Discalaimer and Warranty
  60.  
  61.    Crater  Rim  Software  makes  no  warranty  of  any kind,  express or 
  62.    implied,   including   without   limitation,    any   warranties   of 
  63.    merchantability  and/or fitness for a particular purpose.  Crater Rim 
  64.    Software shall  not  be  liable  for  any  damages,  whether  direct, 
  65.    indirect,  special  or  consequential  arising from a failure of this 
  66.    program to operate in the manner desired  by  the  user.  Crater  Rim 
  67.    Software shall not be liable for any damage to data or property which 
  68.    may be caused directly or indirectly by use of the program.  
  69.  
  70.    IN  NO  EVENT  WILL  Crater  Rim  Software  BE  LIABLE TO YOU FOR ANY 
  71.    DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS OR OTHER INCIDENTAL 
  72.    OR CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR USE OR INABILITY TO  USE 
  73.    THE PROGRAM, OR FOR ANY CLAIM BY ANY OTHER PARTY.  
  74.  
  75. = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
  76. SuperK External Protocol Driver - Revision Log
  77.  
  78. V2.50  - Dated 08/22/88  Initial Release
  79. V2.52  - Dated 09/01/88
  80. V3.10  - Dated 11/05/88
  81. V3.12  - Dated 12/04/88
  82. V3.13  - Dated 12/06/88
  83. V3.14  - Dated 12/27/88
  84. V3.15  - Dated 01/07/89
  85. V3.16  - Dated 01/26/89
  86.  
  87.        Corrected a slight bug in which  SuperK  would report an abnormal
  88.        CPS count.  I suspect this was caused by an immediate abort or by
  89.        a transfer which began before midnight and ended after midnight.
  90.        In any case, SuperK will report a 1 byte CPS in these cases.
  91.  
  92.        Added  the  node charcater to the transfer window frame for those 
  93.        SysOps  who  are  operating  multiple  nodes  in   a   networking 
  94.        environment. 
  95.  
  96.        Added ErrorLevel exit.  If ALL transfers are  successful,  SuperK 
  97.        will  return  an   ERRORLEVEL 0   If ANY ONE of the transfers are
  98.        not successful, SuperK will return an   ERRORLEVEL 1 
  99.  
  100.  
  101. SuperK v3.15  MiniNet's External Protocol Driver
  102.  
  103. Command line parameters :
  104.  
  105.    M        Monitor  Carrier,  abort  if  not  present.  Including  this 
  106.             parameter allows you to use SuperK to transfer files between 
  107.             systems  via  null  modem  cable.  Default  is  ON  (Monitor 
  108.             Carrier).
  109.  
  110.    Dx       Direction of transfer. Where x = R (receive) or S (send)
  111.  
  112.    Px       Comm Port to use. Where x = 1 or 2
  113.  
  114.    Sbaud    Modem Speed. Where baud = 300, 1200, 2400, 4800, 9600, 19200
  115.  
  116.    Tp[b][y] Protocol to use.
  117.               Where p =  X = Xmodem
  118.                          C = CRC Xmodem
  119.                          Y = Ymodem (1k Xmodem)
  120.                          W = WXmodem
  121.                          K = K9Xmodem
  122.                          S = Super8K
  123.  
  124.                     b = Performing  the  transfer  in  Batch mode.  Note 
  125.                         that both computers  MUST  be  using  SuperK  in 
  126.                         order for the Batch mode to be operational. 
  127.  
  128.                     y = SuperK   allows  you  to  specify  if  you  want 
  129.                         overwriting of existing files to  be  performed.  
  130.                         By  including  a  Y  with the Tp parameter,  the 
  131.                         default  overwrite  setting  will  be   reversed 
  132.                         during the current BATCH transfer. 
  133.  
  134.               In single file mode, the X, C, W and Y protocols are fully 
  135.               compatible  with  their  counterparts used on all/most BBS 
  136.               Both systems must be using  SuperK  to invoke the K9Xmodem
  137.               or Super8K Protocols.
  138.  
  139.               Both  y  and  b  are optional.  The  y  overwrite reversal
  140.               only works in Batch mode  (when the  b  is also present).
  141.               If the  b  is omitted, SuperK defaults to single file mode 
  142.  
  143.               A brand new protocol!!!  As is the  case  with  the  other 
  144.               SuperK  protocols,  the  Super8K  protocol  itself  may be 
  145.               executed in either Batch (TSB paramter) or Single File (TS 
  146.               parameter) mode.  Along with a much  improved  throughput, 
  147.               the Super8K protocol also rounds file sizes up to the next 
  148.               higher  128  byte sector,  ala X/WXmodem,  rather than the 
  149.               next higher 1K byte sector, ala Y/K9Xmodem. 
  150.  
  151.               Super8K uses an 8K block with a 1K error  fallback/restart 
  152.               and since it IS NOT a windowing protocol (like WXmodem and 
  153.               K9Xmodem),  the error/abort response time is improved 1000 
  154.               fold!  Super8K also passes the number of file  sectors  to 
  155.               the  receiving  system  so  a  file size and transfer time 
  156.               (approxomate)  is  displayed  on  both  the  sending   and 
  157.               receiving systems. 
  158.  
  159.               Of  course,  the Super8K protocol has its own colors so be 
  160.               sure to setup SuperK before you use it. 
  161.  
  162.               Since  Super8K only does a byte count update each 8K,  the 
  163.               tranfer may seem to  be  taking  a  long  time...  but  in 
  164.               reality....  the following SUPERK.LOG extract displays the 
  165.               preliminary test results for each of the SuperK  protocols 
  166.               and  a  test comparison to Zmodem and Jmodem.  These tests 
  167.               were run between two AT's via Null  Modem  cable.  Results 
  168.               via  modem  will  probably  be  a little lower accross the 
  169.               board. 
  170.  
  171.                 Size    Speed      Cps       Errors   BlkSize    Protocol
  172.               --------------------------------------------------------------
  173.                60800   9600 bps   533 cps  0 errors   0  128   Xmodem   Batch
  174.                60800   9600 bps   769 cps  0 errors   0  128   WXmodem  Batch
  175.                61440   9600 bps   787 cps  0 errors   0 1024   Ymodem   Batch
  176.                61440   9600 bps   869 cps  0 errors   0 1024   K9Xmodem Batch
  177.                60707   9600 bps   861 cps  0 errors   0 1024   Zmodem
  178.                60800   9600 bps   965 cps  0 errors   0 8192   Super8K  Batch
  179.  
  180.                60707   2400 bps   223 cps  0 errors   0 1024   Jmodem
  181.                60707   2400 bps   222 cps  0 errors   0 1024   Zmodem
  182.                60800   2400 bps   262 cps  0 errors   0 8192   Super8K  Batch
  183.               ---------------------------------------------------------------
  184.  
  185.    Nx       Node Letter or Number. Where x = A to Z  or  0 to 9
  186.  
  187.    E        The  E parameter toggles the status of the "erase" flag.  If 
  188.             specified on the command line,  SuperK will  not  erase  the 
  189.             BATCHLST   file  it  creates  when  multiple  filenames  are 
  190.             specified on the command  line  (until  the  next  time  you 
  191.             specify multiple filenames, that is!) 
  192.  
  193.    R        This Command Line Paramter is for use with RBBS-PC.  RBBS-PC 
  194.             utilizes  a  true  Batch  download  with  a single file mode 
  195.             upload.  During uploads,  RBBS-PC includes the full path and 
  196.             filename  for  the f paramter.  Since SuperK Batch modes are 
  197.             TRUE Batch in both downloads and uploads, I have added the R 
  198.             command line switch to tell SuperK that the F parameter  may 
  199.             (or  may  not)  include  a filename.  When SuperK sees the R 
  200.             parameter,  it will look for the last \ or :  characters and 
  201.             parse  all  character  after  that,  thus  leaving  just the 
  202.             download path...  which it then appends to any uploads.  The 
  203.             default is True (non RBBS-PC) batch uploads. 
  204.  
  205.             RBBS command line for Batch Receive using K9Xmodem Batch
  206.  
  207.                SUPERK.COM p[PORT#] s[BAUD] dr r n[NODE] tkb f [FILE]
  208.  
  209.             RBBS command line for Batch Receive using K9Xmodem Batch
  210.  
  211.                SUPERK.COM p[PORT#] s[BAUD] ds r n[NODE] tkb f [FILE]
  212.  
  213.              example:  RBBS-PC passes [FILE] as  C:\RBBS\99\filename.ext
  214.                        (or your defined upload path) during uploads
  215.  
  216.             exclusion  of the  R  command  line parameter  results in an 
  217.             invalid file specification of 
  218.  
  219.                      C:\RBBS\99\filename.ext\
  220.  
  221.             inclusion of the R command line parameter results in a valid 
  222.             file specification of 
  223.  
  224.                      C:\RBBS\99\
  225.  
  226.             for  obvious  reasons,   if  you  use  the  R  command  line 
  227.             parameter,  you  must  include  the  last  \ or at least one 
  228.             superflous (non \ or :  character)  at  the  end  of  the  F 
  229.             specification. 
  230.  
  231.             when using the R paramter...
  232.  
  233.             valid     C:\RBBS\99\*.*       results in   C:\RBBS\99\
  234.             valid     C:\RBBS\99\ABC.PAK   results in   C:\RBBS\99\
  235.             valid     C:\RBBS\99\          results in   C:\RBBS\99\
  236.             invalid   C:\RBBS\99           results in   C:\RBBS\
  237.             no f parameter                 results in   *.*  (all files saved
  238.                                                          in logged drive\dir)
  239.  
  240.             when using the default (non RBBS-PC)
  241.  
  242.             invalid   C:\RBBS\99\*.*       results in   C:\RBBS\99\*.*\
  243.             invalid   C:\RBBS\99\ABC.PAK   results in   C:\RBBS\99\ABC.PAK\
  244.             valid     C:\RBBS\99\          results in   C:\RBBS\99\
  245.             valid     C:\RBBS\99           results in   C:\RBBS\99\
  246.             no f parameter                 results in   *.*  (all files saved
  247.                                                          in logged drive\dir)
  248.  
  249.    F        This  parameter  acts  as a flag for SuperK and denotes that 
  250.             ALL  paramters  after  the  F  are  to  be  interpreted   as 
  251.             filenames. For obvious reasons, this parameter should be the 
  252.             last on specified (before the filenames)!  Each filename may 
  253.             contain a full path in the form: 
  254.  
  255.                  [d:\path\]Filename [d:\path\]Filename   to send/receive.
  256.  
  257.                                   or
  258.  
  259.             You  may  also  specify  the use of a text file containing a 
  260.             list of filenames.  Each filename in the list may contain  a 
  261.             full path. This option is specified as: 
  262.  
  263.                  @drive:\path\Filelist   of files to Batch send.
  264.  
  265.                                   or
  266.  
  267.             You may want to use the second option for file lists... that 
  268.             is,  include a second path where ALL of the files within the 
  269.             list reside. This option is specified as: 
  270.  
  271.                  @drive:\path\listfilename@drive:\path 
  272.  
  273.  
  274.    @        Modify colors/logfile name/xferfile name/options flags...
  275.             Clone SUPERK.COM if changes are made 
  276.  
  277.    The D,  P,  S and T parameters MUST be supplied...  if  operating  in 
  278.    single file mode, the F parameter must be supplied. The B, E, Y, M, N 
  279.    and R parameters are optional...  and the @ parameter is only used to 
  280.    review/modify the default settings (see modification mode below). 
  281.  
  282.    The  DR  and DS parameters are mutually exclusive (only one,  but not 
  283.    both) 
  284.  
  285.    Command Line parameters may be supplied as upper or lower  case,  and 
  286.    may  be entered in any order (except for the F paramter which must be 
  287.    the last one... before any filenames). 
  288.  
  289.  
  290. SUPERK.LOG  -  SuperK will record transfer results to the logfile in the
  291.                following format:
  292.  
  293. +--- Transfer Direction
  294. |  +------- File Size (0 if transfer fails)
  295. |  |      +---------- Modem Speed
  296. |  |      |         +---------- CPS efficiency (0 if transfer fails)
  297. |  |      |         |         +------------- Number of errors
  298. |  |      |         |         |            +-- Dummy for DSZLOG compatability
  299. |  |      |         |         |            | +----- Packet size in bytes
  300. |  |      |         |         |            | |    +--- Filename
  301. |  |      |         |         |            | |    |    Protocol ----++- Batch
  302. |  |      |         |         |            | |    |                 ||
  303. S  27648  1200 bps  108 cps   0 errors     0 1024 C:\DLS\SUPERK.PAK KB
  304.  
  305.  
  306. XFER.TXT - If (and only if) a Node character is specified OR a  question 
  307.            mark  is  used  within  the  XferFile name or SuperK Log file 
  308.            name,  SuperK will also create  a  Xfer  Node  File  to  show 
  309.            success/failure status messages. 
  310.  
  311.            This file has the following format :
  312.  
  313.                 Filename
  314.                 Upload   or   Download
  315.                 Protocol      (X/C/Y/W/K/S/XB/CB/YB/WB/KB/SB)
  316.                 Success  or   Fail
  317.                 EOF           (^Z)
  318.  
  319.            Sample:
  320.  
  321.                 SUPERK.PAK
  322.                 Download
  323.                 KB
  324.                 Success
  325.                 ^Z
  326.  
  327.    The file will be created in the default directory if no drive/path is 
  328.    specified  during  the  command  line  @ parameter modification mode. 
  329.    While in batch mode,  only the first file transfer  results  will  be 
  330.    logged to this file.  However, SUPERK.LOG will contain the results of 
  331.    all files transferred in the batch. 
  332.  
  333.  
  334. Command Line @ Parameter Modification Mode.
  335.  
  336.    Starting  SuperK  with  the  @ command line parameter will put SuperK 
  337.    into its default modification mode.  SuperK will  first  display  its 
  338.    current  default settings and then prompt you for any changes you may 
  339.    wish to make.  Note  that  entering  a  blank  line  (simply  hitting 
  340.    [Enter])  will  leave  the  current  setting  intact.  SuperK  allows 
  341.    modification to the colors it uses,  the logfile name,  the xfer file 
  342.    name (for BBS use) and certain operational flags.
  343.  
  344.    C - Modifying colors:
  345.  
  346.        This  one's  easy!  After  selecting  the  C option,  SuperK will 
  347.        display the 127 color palette that it supports.  Simply select  a 
  348.        number  for  each  of  the  5  colors  used...  SuperK will cycle 
  349.        through  all  5   colors,   updating   the   "current   settings" 
  350.        accordingly.  If  you  don't  want  to  change  a  current  color 
  351.        setting,  simply hit the [Enter] key and SuperK will move  on  to 
  352.        the next setting. The 5 color types are: 
  353.  
  354.           Xcolors for Xmodem/Xmodem CRC/WXmodem transfers
  355.           Kcolors for K9Xmodem transfers
  356.           Ycolors for Ymodem transfers
  357.           Scolors for SuperK transfers
  358.           Ucolors for universal display of the SuperK logo and batch
  359.                       filenames
  360.  
  361.    L - Logfile Name:
  362.  
  363.        This  is  the  filename  SuperK uses to record the results of any 
  364.        tranfers it performs.  SuperK will accept upto 40  characters  so 
  365.        you  may include a full drive:\path\ along with the logfile name. 
  366.        Additionally,  you may use a question mark (?) as one  (and  only 
  367.        one)  of  the  logfile  name  characters.  If  a question mark is 
  368.        present,  SuperK will substitute the Node character in its place.  
  369.        If  no node character is specified,  SuperK will use the letter A 
  370.        as a Node character.  The letter A is  substituted  ONLY  if  the 
  371.        question  mark is encountered in the logfile name.  If you do not 
  372.        want SuperK to maintain a logfile, simply enter a backslash (\).. 
  373.        which will inform SuperK to  blank  out  the  logfile  name.  The 
  374.        default logfile name is SUPERK.LOG 
  375.  
  376.    X - XferFile Name:
  377.  
  378.        This  is  the filename SuperK uses to record transfer results for 
  379.        use by BBS programs.  Its format and modification is identical to 
  380.        the Logfile Name. The default Xferfile name is XFER.TXT
  381.  
  382.    O - Overwrite:
  383.  
  384.        This flag setting tells SuperK whether or not  in  can  overwrite 
  385.        existing files during Batch mode transfers. The default is NO 
  386.  
  387.    S - Save Aborts:
  388.  
  389.        This  flag  setting tell SuperK whether or not it should keep any 
  390.        partial files which were aborted during transfer. This flag holds 
  391.        for any protocol - batch or single file mode. The default is YES 
  392.  
  393.    W - Write On 0:
  394.  
  395.        This flag setting tells SuperK whether or not  it  should  create 
  396.        the  XferFile when a transfer is not successfully completed.  The 
  397.        status of this flag is the last check that  SuperK  makes  before 
  398.        creating the XferFile. A node character and XferFile Name must be 
  399.        specified before the Write On 0 flag comes into play. The default 
  400.        is YES 
  401.  
  402.    [Enter] Quit:
  403.  
  404.        If you only wish to view the current default settings, simply hit 
  405.        [Enter]  to  exit  back  to  DOS.  If any changes have been made, 
  406.        SuperK will go into its cloning mode and ask if you want to clone 
  407.        SuperK to preserve the new changes.  Note that you MUST press the 
  408.        Y key in order to clone SuperK.  Hitting [Enter] here will simply 
  409.        return you to DOS without saving your changes within  the  SuperK 
  410.        program. 
  411.  
  412.  
  413. Program control keys:
  414.  
  415.        SuperK will recognize either the [Esc] key or ^X (control X)  key 
  416.        during  transfers and will abort the current transfer,  returning 
  417.        you  to  DOS.   Note  that  the  streaming  protocols   (Wxmodem, 
  418.        K9Xmodem) may require several [Esc] or ^X to abort the transfer. 
  419.  
  420.  
  421. Batch transfers:
  422.  
  423.        SuperK  is  capable  of  sending  and receiving multiple files in 
  424.        batch mode.  Since this protocol driver was written for use  with 
  425.        my  MiniNet BBS package...  the sending of the file creation date 
  426.        (ala DSZ and Telink) tends to drive  me  up  the  wall,  creating 
  427.        quite  a  bit  of  confusion  in keeeping track of newly acquired 
  428.        files! 
  429.  
  430.        For this reason the major difference between  SuperK  Batch  mode 
  431.        and  other  Batch  modes is that SuperK Batch only sends the File 
  432.        Name and does not send the file size or file creation date. 
  433.  
  434.        During Batch mode transfers, SuperK will display the last 3 files 
  435.        requested under the SuperK logo so that you may  have  a  running 
  436.        update  of  what's  happening.  The  present transfer progress is 
  437.        displayed in its own window alongside the SuperK logo. 
  438.  
  439.        SuperK is able to handle multiple filenames on the command  line.  
  440.        The command syntax remains the same but if more than one filename 
  441.        is specified, SuperK will create its own BATCHLST file. If a Node 
  442.        character  is specified on the command line,  that character will 
  443.        be used for the extension of BATCHLST.  The default is "A" if  no 
  444.        node character is specified. 
  445.  
  446.        The number of filenames that can be specified will depend largely 
  447.        on  your  own particular system setup,  the string length used by 
  448.        your calling program and the individual filename lengths.
  449.  
  450.        This feature is only active while in  Batch  Send  Mode  (receive 
  451.        automatically  gets  filename  from  sender),  the  command  line 
  452.        paramaters can be in any order,  NO WILDCARDS  ARE  ALLOWED,  the 
  453.        first  filename  MUST  be preceeded by an F (upper or lower case) 
  454.        and EACH filename may include a full path. 
  455.  
  456.        Your command line should look like ...
  457.  
  458.               SUPERK p1 s9600 dS tWB f FILE1 FILE2 FILE3
  459.  
  460.        Since the BATCHLST is created internally (by SuperK), SuperK will 
  461.        erase  the  BATCHLST  file  once  it  is done with it...  You may 
  462.        override this by including an  E  as  one  of  the  command  line 
  463.        paramters.  The  E  parameter  toggles  the status of the "erase" 
  464.        flag. If specified on the command line, SuperK will not erase the 
  465.        BATCHLST  file  (until  the  next  time  you   specify   multiple 
  466.        filenames, that is!) 
  467.  
  468.        New with v3.00 is the ability to supply  an  external  path  when 
  469.        using the  @C:filelist  option in either batch upload or download 
  470.        modes. The format is  @drive:\path\filelist@drive:\path 
  471.  
  472.    Receiving files in Batch mode:
  473.  
  474.        You do  not  have  to  supply  any  filename  during  batch  mode 
  475.        receives. You may of course, include a full drive:\path\ in place 
  476.        of a filename.  Use the F command line parameter to designate the 
  477.        path  in  the  form:  f  C:\FOO\BAR (with or without the trailing 
  478.        backslash).  And...  DO NOT specify the f parameter if no path or 
  479.        filename is specified. 
  480.  
  481.    Sending files in batch mode:
  482.    
  483.        You  may  use  any  valid  DOS  wildcard configuration with the F 
  484.        parameter. 
  485.  
  486.        Additionally,  you may specify a list of filenames for SuperK  to 
  487.        send.  The list filename is specified as @C:listfilename 
  488.  
  489.        You may of course, include a full drive:\path\  when using the  @ 
  490.        option. 
  491.  
  492.        The  filenames  in  the list may contain a full drive:\path\ (the 
  493.        same or different) for each filename. 
  494.  
  495.        SuperK is capable of reading  and  extracting  filenames  from  a 
  496.        standard  -  single  line  - BBS files listing.  If you use a BBS 
  497.        type files  listing,  and  call  SuperK  from  the  comm  or  BBS 
  498.        directory,  you  will  have  to add the full drive:\path\ to each 
  499.        filename in the list if the files to send do not  reside  in  the 
  500.        default  directory.  There are other ways of accessing files that 
  501.        reside in directories other than the default (default upload  and 
  502.        download  directories,  etc.),  but  I won't go into this area as 
  503.        most comm and BBS programs do this work for you (K9X does it  ALL 
  504.        for you... automatically!) 
  505.  
  506.  
  507. Examples:
  508.  
  509.    1.  Use COM1, 1200 baud, Xmodem, Send files MYFILE.DOC and FILE.COM
  510.  
  511.         SUPERK p1 s1200 tX dS f MYFILE.DOC FILE.COM
  512.  
  513.    2.  Use COM2,  19200 baud,  Ymodem Batch,  Receive file *.DOC, do not 
  514.        monitor carrier, override the default "do not overwrite". 
  515.  
  516.         SUPERK p2 s19200 tYBY dR m
  517.  
  518.        Note: The protocol character must follow  the  t.  The  second  Y 
  519.              above  is  the  override for the overwrite flag.  The B and 
  520.              second Y may be in any order just as long as they  are  the 
  521.              third and fourth characters in the t parameter. 
  522.  
  523.    3.  Use COM1,  9600 baud,  K9Xmodem Batch Send  files  in  MYLIST.LST 
  524.        which  resides  in  my  C:\BBS\  directory.  The  files listed in 
  525.        MYLIST.LST reside in various directories on different drives.  Do 
  526.        not  monitor  carrier  and record success results to Node A of my 
  527.        BBS. 
  528.  
  529.         SUPERK p1 s9600 tKB dS m nA f @C:\BBS\MYLIST.LST
  530.  
  531.         C:\BBS\MYLIST.LST looks like this:
  532.  
  533.           ABC.PAK              (this one resides in the default directory)
  534.           D:\FOO\BAR\MYGAME.EXE
  535.           E:\LOTUS\123GRAPH.PAK
  536.  
  537.        XFER.TXT  (or  XFERA.TXT if ?  specified in the  default xferfile 
  538.        name) will reflect the results of the transfer.  Note  that  only 
  539.        the  first filename  and  its transfer results will be present in 
  540.        XFER.TXT.  SUPERK.LOG will however,  contain the results  of  all 
  541.        three files. 
  542.  
  543.    4.  Use COM2,  19200 baud,  K9Xmodem Batch Send only files containing 
  544.        an PAK extension and residing in my C:\DLS directory,  and  don't 
  545.        monitor carrier. 
  546.  
  547.         SUPERK p2 s19200 tKB dS m f C:\DLS\*.PAK
  548.  
  549.    5.  Use COM2,  19200 baud,  K9Xmodem Batch Receive files - store them 
  550.        in my C:\DLS directory. 
  551.  
  552.         SUPERK p2 s19200 tKB dR f C:\DLS
  553.  
  554. There are 3 sample batch files included in SUPERK.PAK 
  555.  
  556.     SEND.BAT  - this batch file is set up for sending file(s) to
  557.                 another system
  558.  
  559.     RECV.BAT  - this batch file is set up to receive file(s) from 
  560.                 another system
  561.  
  562.     SUPER.BAT - this batch file will handle transfers in either 
  563.                 direction
  564.  
  565. Executing  any  one  of  the  batch files without any parameters (or the 
  566. wrong parameter) will  display  a  short  message  showing  the  correct 
  567. calling  procedure  and  parameter  choices.   Since  SUPER.BAT  handles 
  568. transfers in either Send or Receive mode,  it  naturally  requires  more 
  569. information in order to perform correctly.
  570.  
  571. NOTE: If you are operating a MiniNet BBS v18.00 or above... or K9X v8.20 
  572.       or  above...  access  to SuperK is handled internally and does not 
  573.       require the use of the batch files. 
  574.  
  575.       If you are not... please read the enclosed PRODUCTS.TXT file...
  576.       It's worth a look! 
  577.  
  578.       For pure BBS'ing, K9X can't be beat!
  579.  
  580.  ------------------------------------------------------------------------------
  581.     I  have  been  using  this protocol driver on Underdog's MiniNet for 
  582.     quite some time now.  If you need more information  on  the  various 
  583.     transfer  protocols,  please get a copy of K9X (my comm program) and 
  584.     review the K9X.DOC file contained in that package.  All  suggestions 
  585.     are  gratefully  received  and  reviewed! Let me know... 
  586.  
  587.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  588.     N O T I C E    N O T I C E    N O T I C E    N O T I C E    N O T I C E
  589.  
  590.     Due to the amount of time and money I have spent setting up  SuperK  for 
  591.     use with your Comm/BBS programs,  I am requesting that you please send a 
  592.     small contribution ($25.00 suggested) to compensate for the man hours  I 
  593.     have spent developing, modifying and setting up this protocol driver.
  594.    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  595.  
  596.                    Sal Manaro  dba  Crater Rim Softare
  597.                            4028 41st Ave South
  598.                           Seattle, Wa 98118 USA
  599.                           (206) 723-6728  voice
  600.  
  601.                    Underdog's MiniNet  (206) 725-9233
  602.                 1200/2400/9600  24hrs   600 megs OnLine
  603.                 Supporting 22 files transfer protocols!
  604.  
  605.                            Enjoy,
  606.                                Sal Manaro
  607.  
  608.  
  609.